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1.  Introduction 


The  Advanced  RISC  Machine  (ARM)  architecture  has  become  popular  by  its  integration  into 
many  embedded  applications.  Platforms  include  mobile  phones,  handheld  game  systems,  and 
industrial  control  systems  since  the  1980s.  The  ARM  architecture  has  since  found  a  niche  in  the 
embedded  programming  community,  striking  an  often-needed  balance  between  power  and  size. 
These  microcontrollers  provide  more  computational  ability  than  smaller  Microchip  peripheral 
interface  controllers  or  AVR  microcontrollers,  while  at  the  same  time  requiring  less  power  and 
consuming  less  volume  than  larger  von  Neuman-based  computing  systems. 

The  particular  application  being  presented  uses  the  Atmel  SAM7S256  board  (figure  1),  which  is 
readily  available  in  the  United  States  from  several  commercial  online  vendors  such  as  Sparkfun. 
The  AT91SAM7S256  chip  is  currently  being  used  internally  as  the  centerpiece  of  a  new  small- 
scaled  autopilot  for  unmanned  air  and  ground  vehicles.  Though  many  parts  of  the  development 
environment  stem  from  already  available  open  source  material,  other  components  were  prepared 
internally.  The  most  daunting  task  was  deciphering  the  more  than  700-page-long  manual  on 
programming  the  ARM7.  The  results  were  distilled  into  several  example  files  as  well  as  the 
accompanying  header  files  used  to  program  the  chip  accordingly. 


Figure  1.  Atmel  SAM7S256 

development  header  board. 

The  following  section  includes  step-by-step  instructions  on  acquiring  the  needed  hardware  and 
software  and  setting  up  the  development  environment  in  Ubuntu  Linux  8.04  for  programming  the 
ARM7  chipset.  The  appendix  includes  sample  files  for  process  verification.  In  order  to  make 
the  material  tractable  to  all  users,  including  non-Linux  users,  additional  process  details  are 
included  to  improve  consistency  in  the  results. 
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2.  Procedure 


The  first  step  is  to  have  a  working  installation  of  the  Linux  operating  system  available.  It  is 
recommended  to  start  from  a  fresh  Linux  installation,  preferably  the  latest  version  of  Ubuntu. 
This  setup  has  been  tested  with  Ubuntu  8.04  long-term  support  but  should  be  compatible  with 
future  iterations  of  the  operating  systems.  Once  Ubuntu  has  been  properly  installed,  the  update 
manager  should  update  the  system.  Though  it  may  be  enough  to  only  include  the  Subversion 
version  repository  control  program  and  libmpfr  from  the  Synaptic  Package  Manager,  it  is  also 
recommended  that  the  user  installs  the  build-essential,  autoconf,  automake,  and  libtool  packages 
as  well.  These  files  will  update  the  compilation  environment  as  discussed  later  on.  The  apt-get 
command  in  a  terminal  window  is  also  an  alternative  to  the  Synaptic  Package  Manager  method 
of  downloading  the  updates,  e.g.,  apt-get  install  libtool. 

The  next  step  is  to  download  the  development  environment  for  the  ARM7.  The  example  files 
are  downloaded  by  entering  the  following  into  the  command  terminal  after  changing  the 
directory  to  the  desired  folder.  One  can  create  a  directory  src  in  the  user’s  home  directory, 
change  to  that  directory,  and  then  obtain  the  files  as  follows: 

user@host:~$  sudo  svn  co  --username=guest  http://is.cx/svn/AT91SAM7  AT91SAM7 

Once  the  files  are  retrieved,  download  the  GNU  ARM  (GNU  is  not  Unix  ARM)  toolchain,  which 
provides  the  modified  C  compiler  for  the  ARM7  architecture.  This  software  and  additional 
mirrors  can  be  found  on  the  GNU  ARM  Web  site.h^  Depending  on  whether  the  user  is  running  a 
32-  or  64-bit  system,  a  set  of  precompiled  binaries  may  or  may  not  be  available.  If  the  binaries 
are  not  available  for  the  particular  platform,  then  the  source  code  must  be  downloaded  and 
compiled  using  the  make  file  (a  script  that  sends  instructions  on  how  the  program  should  be 
compiled),  which  will  be  identified  as  Makefile  within  the  folder. 

Because  the  current  toolset  is  dependent  on  libraries  from  version  3.4.3  of  the  GNU  ARM 
toolchain,  the  Makefile  in  the  latest  version  of  the  toolchain  will  have  to  be  modified  to  point  to 
the  appropriate  libraries.  Inside  the  Makefile  are  hard-coded  paths  that  may  or  may  not  point  to 
the  correct  location.  Look  over  each  path  and  update  any  that  appear  to  point  in  the  wrong 
location.  If  it  is  unclear  whether  the  paths  are  correct  or  not,  check  to  see  if  the  program  or 
library  exists  in  the  specified  path.  Next,  edit  the  .bashrc  in  the  user’s  home  directory  through 
the  terminal  by  typing: 

user@host:~$  nano  -w  -/.bashrc 


'  GNU  ARM  Home  Page,  http://www.gnuarm.com  (accessed  3  March  2009). 
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Amontec  Home  Page,  http://amontec.com  (accessed  13  August  2009). 
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Modify  the  .bashrc  path  file  to  refleet  the  addition  of  the  GNU  ARM  tool  ehain.  Append  the 
export  path  to  the  end  of  the  file  and  save: 

export  PATH=$PATH:/usr/local/gnuarm-4,3,2/bin 

Compile  the  modules  used  by  all  the  AT91SAM7  examples  and  projeets  by  ehanging  to  the 
modules  direetory,  updating  the  Makefile  if  necessary,  and  typing  make.  This  action  will  create 
the  libarm.a  static  library,  which  is  essential  for  the  examples  and  projects  discussed  herein.  The 
libarm.a  library,  provides  a  number  of  utility  functions  to  make  serial,  I  C  (Inter-Integrated 
Circuit),  and  SPI  (Serial  Peripheral  Interface  Bus)  communications  possible  using  only  a  couple 
lines  of  code.  The  library  also  provides  additional  utilities  for  configuring  pins,  setting  the  clock 
speed,  managing  power,  performing  analog-to-digital  conversions,  etc. 

With  the  libarm.a  now  compiled,  change  the  directory  into  the  timer  directory.  This  is  located 
within  the  examples  directory.  Try  to  compile  this  example  by  typing  the  following  two 
commands:  make  clean  followed  by  make.  If  the  previous  steps  were  successful,  then  the  fide 
named  main.bin  will  have  been  generated.  This  is  the  AT91SAM7S25 6-specific  binary  program 
that  will  be  placed  in  the  flash  memory  of  the  microcontroller. 

Next,  download  the  Linux  SAM  (Smart  ARM-based  Microcontroller)  boot  assistant  from 
linux4sam.org^.  Once  again,  the  option  is  available  to  download  either  binaries  or  source  code 
from  the  software  tools  menu.  An  explanation  is  also  provided  on  the  linux4sam.org  Web  site 
for  the  procedure  for  mounting  the  USB  (Univeral  Serial  Bus)  to  the  serial  device  (figure  2)  so 
that  the  computer  will  communicate  with  the  ARM7  kit.  It  is  recommended  that  the  lines  in 
figure  3  be  inserted  into  a  shell  file  for  future  use.  If  the  .sh  file  is  executed  once,  it  should  not 
be  necessary  to  run  it  again  on  the  same  machine  until  it  is  rebooted  again.  Write  the  instructions 
in  a  preferred  text  editor  such  as  Nano,  VIM,  or  Emacs  and  save  as  configure_samba.sh.  Then 
type  chmod  +x  configure _samba.sh  to  make  the  file  executable.  Finally,  type 
./configure _samba.sh  to  run  the  file. 

At  this  time,  the  SAM7256  header  board  may  be  connected  to  the  PC.  To  allow  programming 
initially,  clear  the  lock  from  the  device  by  moving  the  TST  (test)  jumper  across  the  two  available 
pins  and  plugging  in  the  USB  outlet  to  a  power  source  (figure  4).  After  10  s,  disconnect  the  USB 
cable  from  the  header  board  and  move  the  jumper  to  its  original  open  position. 


3 


Linux4SAM  Home  Page.  http://www.linux4sam.org/twiki/bin/view/Linux4SAM/SoftwareTools  (accessed  3  March  2009). 
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Figure  2.  Linux4SAM  Web  site  screenshot. 


sudo  rmmod  usbserial 

sudo  modprobe  usbserial  vender=0x03eb  product=0x6124 
sudo  Isusb  -d  03eb:6124 


Figures.  Example  .sh  file. 


Figure  4.  Diagram  of  header  board  with  TST  jumper  removed. 

The  device  should  now  be  ready  for  programming.  A  useful  way  to  determine  if  the 
communications  are  successful  is  to  display  a  live  system  log  in  the  terminal  window  to  see  if  the 
computer  recognizes  the  device  when  it  is  plugged  in.  This  can  be  accomplished  by  typing  the 
following  line  in  the  command  window: 

user@host:~$  tail  -f  /var/log/syslog 
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The  tail  -f  command  appends  the  most  recent  lines  from  the  file  syslog  in  /var/log/ to  the 
command  window  display.  From  syslog,  the  user  is  able  to  view  the  current  system  actions 
including  the  response  to  any  external  USB  devices  recently  added.  The  display  to  the  window 
should  resemble  new  full  speed  USB  device  using  ehcijicd  and  address  X,  where  X  may  be  any 
number  applicable  to  a  particular  machine. 

Once  the  system  log  file  indicates  that  a  new  device  (i.e.,  /dev/ttyUSBO)  has  been  created,  run  the 
SAM-BA  (Smart  ARM-based  Microcontrollers  Boot  Assistant)  application  to  begin 
programming  the  chip  (figure  5).  (Change  the  directory  to  where  SAM-BA  was  installed,  which 
most  likely  will  be  /home/user _name/src/sam-ba_cdc_2.8dinux_01/.  Run  SAM-BA  by  typing 
./sam-ba_cdc_2.8Jinux_01  (one  may  have  to  input  chmod  +x  sam-ba_cdc_2.8dinux_01  to  mark 
the  file  as  executable).  The  current  device  should  already  be  selected  as  the  current  connection 
/dev/ttyUSBX,  where  X  can  be  any  number  depending  on  the  number  of  other  serial-to-USB 
devices  connected  to  the  machine.  Also  select  AT91SAM7S256-EK  as  the  board  to  program.  In 
the  window  that  opens  up,  select  the  folder  to  the  left  of  the  send  file  button  and  locate  the 
main.bin  from  the  timer  directory.  Once  the  main.bin  is  selected,  click  the  send  file  button  and 
answer  yes  to  any  prompts  regarding  locking  and  unlocking  the  module. 


Figure  5.  SAM-BA  graphical  user  interface  screenshot. 


At  this  point,  the  header  boards  should  be  programmed.  Disconnect  and  then  reconnect  the  USB 
cable  or  power  source  from  the  development  board.  The  status  light-emitting  diode  (LED)  on 
the  development  board  should  now  be  blinking.  The  user  may  return  to  the  main.c  file  for  the 
timer  and  change  the  frequency  at  which  the  LED  on  the  header  board  will  blink  by  changing  the 
DIV128  expression  to  DIV32.  This  same  general  procedure  may  be  followed  to  run  any  of  the 
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other  examples  provided  or  any  original  code  that  may  be  generated  by  the  user  for  future  use.  It 
may  be  useful  to  copy  a  working  Makefile  from  another  example  directory  instead  of  modifying 
it  each  time. 


3.  Future  Applications 


The  development  environment  is  arranged  to  allow  easy  transition  when  programming  the 
ARM7  autopilot.  In  the  future,  filtering  and  estimation  methods  will  be  applied  to  the  autopilot, 
which  will  then  be  used  as  a  controller  for  small-  and  microscale  air  and  ground  vehicles  within 
the  scope  of  the  Vehicle  Technology  Directorate’s  unmanned  systems  research. 
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Appendix.  Sample  Code 


This  appendix  appear  in  its  original  form,  without  editorial  change. 
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#include  "board.h" 

#include  "pio.h" 

#include  "tc.h" 

#include  "lowlevel.h" 

unsigned  int  FiqCount  =  0; 

static  void 

TimerIrqHandler  (void) 

{ 

AT91C_BASE_TC2->TC_SR;  /*  read  TC  Status  Register  to  clear  interrupt  */ 

if  ((AT91C_BASE_PIOA->PIO_ODSR  &  EEDSTATUS)  ==  EEDSTATUS) 

{ 

AT91C_BASE_PIOA->PIO_CODR  =  EEDSTATUS;  /*  turn  status  on  */ 

} 

else 

{ 

AT91C_BASE_PIOA->PIO_SODR  =  EEDSTATUS;  /*  turn  status  led  off*/ 

} 

} 


int 

main  (void) 

{ 

low  level  init  (EXT  OSC,  PEE  DIV,  PEE  MUL,  PRESCALE); 

/*  PIO  Enable,  AB  Select  (0=A),  Output  Enable,  Default  Output  State,  Pull-Up  Enable,  Eilter 
Enable,  PCfNT  Enable,  Multi-Drive  Enable  */ 

pio  init  (LED  MASK,  OxEEEEEEEE,  0,  LED  MASK,  LED  MASK,  0,  0,  0,  0); 

/*  Timed  Interrupt  Example  */ 

tc  init  (TC2,  TC_DIV32,  TC  COMPARE,  37500,  TimerIrqHandler,  4); 
while  (1)  {} 

i _ 


Figure  A- 1.  Time  example. 
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************************************************************* 

#  Makefile  for  flash  execution 

#  Use  "make  64"  for  AT91SAM7S64  or  "Make  256"  for  AT91SAM7S256 . 

#  Default  is  "make  64" 

#  variables 

CC  =  arm-elf-gcc 

LD  =  arm-elf-ld  -v 

AR  =  arm-elf-ar 

AS  =  arm-elf-as 

CP  =  arm-elf-ob j copy 

OD  =  arm-elf-ob j dump 

CFLAGS  =  -I . /  -Imodules/  -c  -fno-common  -Wall  -Os 

CASMFLAGS  =  -Imodules/  -Os  -c  -g  -Wa,-a,-ad 

#  AFLAGS  =  -ahls  -mapcs-32  -o  crt . o 

#  LFLAGS  =  -Map  main. map  -T$ (LINKER_SCRIPT) 

CPFLAGS  =  --output-target=binary 

ODFLAGS  =  -X  --syms 

GNUARM  =  /usr/local/gnuarm-3 . 4 . 3 

OUT  =  libarm7.a 

#GNUARM  =  /c/Program\  Files/GNUARM 

OBJECTS  =  tc.o  isrsupport.o  lowlevel.o  status_led.o  usart.o  adc . o  pio.o  pmc . o 
usb.o  pwm.o  spi . o  vreg.o  wdt . o  aic.o  twi . o  pdc . o 

OBJECTS_LST  =  tc.lst  isrsupport . 1st  lowlevel . 1st  status_led . 1st  usart.lst 
adc. 1st  pio.lst  pmc. 1st  usb.lst  pwm.lst  pwm.lst  spi. 1st  vreg.lst  wdt. 1st 
aic.lst  twi. 1st  pdc. 1st 

64:  CFLAGS  +=  -DMCU=64 

64:  LINKER_SCRIPT  =  AT91SAM7S64 . Id 

64:  $(OUT) 

256:  CFLAGS  +=  -DMCU=256 

256:  LINKER_SCRIPT  =  AT91SAM7S256 . Id 

256:  $(OUT) 

clean : 

-rm  -f  $ (OBJECTS)  $ (OBJECTS_LST)  $  (OUT) 

$  (OUT)  :  $ (OBJECTS)  $ (LINKER_SCRIPT) 

@  echo  "..linking" 

#  $ (AR)  res  $(OUT)  $ (OBJECTS) 

$  (AR)  res  $ (OUT)  $ (OBJECTS)  $ (GNUARM) /arm-elf /lib/libc . a  $ (GNUARM) /arm- 
elf /lib/ libm  . a  $ (GNUARM) /lib/gcc/arm-elf /3 . 4 . 3/libgcc . a  $ (GNUARM) /arm- 
elf  /lib/libg  .  a 

lowlevel.o:  lowlevel. c 

$ (CC)  $ (CASMFLAGS)  lowlevel.o  >  lowlevel. 1st 
$(CC)  $ (CFLAGS)  lowlevel.o 

tc.o:  tc . c 

$(CC)  $ (CASMFLAGS)  tc . c  >  tc.lst 

$(CC)  $ (CFLAGS)  tc.c 

isrsupport.o:  isrsupport.o 

Figure  A-2.  Makefile  for  building  modules. 
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$ (CC)  $(CASMFLAGS)  isrsupport.c  >  isrsupport . 1st 
$ (CC)  $(CFLAGS)  isrsupport.c 

status_led . o :  status_led.c 

$ (CC)  ${CASMFLAGS)  status_led.c  >  status_led. 1st 
$(CC)  $(CFLAGS)  status_led.c 

usart.o:  usart.c 

$(CC)  ${CASMFLAGS)  usart.c  >  usart.lst 
$(CC)  ${CFLAGS)  usart.c 

adc . o :  adc . c 

$(CC)  $(CASMFLAGS)  adc . c  >  adc. 1st 
$(CC)  $(CFLAGS)  adc.c 

pio.o:  pio.c 

$(CC)  $(CASMFLAGS)  pio.c  >  pio.lst 
$(CC)  $(CFLAGS)  pio.c 

pmc . o :  pmc . c 

$(CC)  $(CASMFLAGS)  pmc . c  >  pmc. 1st 
$(CC)  $(CFLAGS)  pmc.c 

usb.o:  usb.c 

$(CC)  $(CASMFLAGS)  usb.c  >  usb.lst 
$(CC)  $(CFLAGS)  usb.c 

pwm . o :  pwm . c 

$(CC)  $(CASMFLAGS)  pwm.c  >  pwm. 1st 
$(CC)  ${CFLAGS)  pwm.c 

spi.o:  spi.c 

$(CC)  $(CASMFLAGS)  spi.c  >  spi.lst 
$(CC)  $(CFLAGS)  spi.c 

vreg . o :  vreg . c 

$ (CC)  $(CASMFLAGS)  vreg . c  >  vreg. 1st 
$(CC)  $(CFLAGS)  vreg.c 

wdt . o :  wdt . c 

$(CC)  $(CASMFLAGS)  wdt . C  >  wdt. 1st 
$(CC)  $(CFLAGS)  wdt.c 

aic.o:  aic.c 

$(CC)  $(CASMFLAGS)  aic.c  >  aic.lst 
$(CC)  $(CFLAGS)  aic.c 

twi . o  :  twi  .  c 

$(CC)  $(CASMFLAGS)  twi . c  >  twi. 1st 
$(CC)  $(CFLAGS)  twi.c 

pdc . o :  pdc . c 

$(CC)  $(CASMFLAGS)  pdc . C  >  pdc. 1st 
_ S(CC)  S(CFLAGS)  pdc.c _ 


Figure  A-2.  Makefile  for  building  modules  (eontinued). 
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only)  DTIC  OCA 

8725  JOHN  J  KINGMAN  RD 
STE  0944 

FORT  BELVOIR  VA  22060-6218 

1  DIRECTOR 

US  ARMY  RESEARCH  LAB 
IMNE  ALC  HRR 
2800  POWDER  MILL  RD 
ADELPHI  MD  20783-1197 

1  DIRECTOR 

US  ARMY  RESEARCH  LAB 
RDRL  CIM  L 
2800  POWDER  MILL  RD 
ADELPHI  MD  20783-1197 

1  DIRECTOR 

US  ARMY  RESEARCH  LAB 
RDRL  CIM  P 
2800  POWDER  MILL  RD 
ADELPHI  MD  20783-1197 


ABERDEEN  PROVING  GROUND 

1  DIR  USARL 

RDRL  CIM  G  (BLDG  4600) 
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Intentionally  left  blank. 
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